home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / who298.zip / WHOCALL.DOC < prev    next >
Text File  |  1992-09-17  |  9KB  |  210 lines
  1. Who Called? Version 2.9
  2.  
  3. 18 September 1992
  4.  
  5. PCBoard is owned by Clark Development Inc.
  6. Who Called? is owned by Bill Fink - User Friendly Systems.
  7.  
  8. PLEASE read this WHOLE note BEFORE You report problems?!
  9.  
  10. The first item I guess everyone goes over with any utility
  11. that's written is the "I am not responsible" routine. Sorry
  12. guys/ladies, the same goes here. You KNOW what I mean. You
  13. are using WhoCalled? at your own risk. 
  14.  
  15. I WILL say this, WhoCalled? is a VERY simple utility 
  16. that merely LOOKS at the callers file. It writes NOTHING 
  17. to PCBoard's associated files.
  18.  
  19. Who Called? writes a bulletin (CALLED "BULLETIN")
  20. for PCBoard SysOps with the output that lists a users session 
  21. on a PCBoard BBS. With the following information;
  22.  
  23. The OutPut text looks like this:
  24.  
  25. BBS Name Goes Here  - Node : 9
  26. Who Called? - V2.98 - Written By: Bill Fink
  27.  
  28.                              Time  Min. Connect #Msgs  Files  Files  Avg
  29. Date      User Name          On    Used Speed    Left   U/L    D/L   CPS
  30. ----------------------------------------------------------------------------
  31. 03-23-92  HORACIO CRISTINO   20:51  4   (2400)     0      0     0
  32. 03-23-92  ALEX BOWMAN        20:07  25  (19200E)   4      0     0
  33. 03-23-92  MARTIN HARDY       18:48  52  (2400)     0      0     2    230
  34. 03-23-92  MITCH KRZYZEK      18:43  1   (2400)     0      0     0
  35. 03-23-92  BILL FINK          13:32  10  (2400)     1      0     0
  36. 03-23-92  MIKE GERARDI       12:55  8   (2400)     0      0     1    232
  37. 03-23-92  BILLS TESTING      00:06  0   (Local)    0      0     0
  38.  
  39. Previous xx Callers Tracked.
  40.  
  41.  
  42. A NICE little gem of a utility. The OUTPUT file is called
  43. BULLETIN. All you need to do is copy the file BULLETIN, AFTER
  44. WhoCalled? is ran, to your designated "BULLxx" file.
  45.  
  46. The biggest and foremost reason for writing this utility, is
  47. to write something that doesn't have "NOT REGISTERED" all
  48. over the place. Some of the "OTHER" utility writers must
  49. think it's OK when they post all over the bulletins, that
  50. the SysOp is a "Cheap" person and will not send them any money
  51. for their work.
  52.  
  53. I AM a SysOp, and I am NOT cheap! I've spent WELL into many
  54. thousands of dollars on my BBS, it's software and
  55. utilities. You know as well as I do, how much TIME goes into
  56. your BBS! You are NOT cheap either.
  57.  
  58. I am making a vow RIGHT HERE AND NOW, that I will NEVER post
  59. anything to the effect of "Your SysOp Is Cheap" in ANY "Who
  60. Called?" products!
  61.  
  62.  
  63. * * * SINGLE NODE USERS! MAKE SURE YOU USE A ZERO "0" In
  64.       your WHOCALL.CNF file as your node number!
  65.       This software WILL work with Clark's new 2 Node 
  66.       version of the code.
  67.  
  68. The BBSes who DID test the product did NOT have ANY problems
  69. with their "CALLER" or WHOCALL.CNF file(s). If YOU DO,  I
  70. trust I  have written enough error trapping to catch any
  71. mistake that MAY have happened on your part. If this is the
  72. case, the utility will beep at you and the bulletin created
  73. will simply have the bulletin header (and nothing else) and
  74. go on about it's business. Your board will be back up when
  75. it's through.
  76.  
  77. You WILL run into problems if you've edited your CALLERs 
  78. file. The contents of PCBoard's CALLERS file is written
  79. as a relative type file and if you edit the file with an
  80. ASCII editor, (OK in MOST cases) you COULD have a distorted
  81. output file as your bulletin. 
  82.  
  83.                         * THIS IS OK * WHOCALLED? WILL
  84.                           trap it, but needs to cycle
  85.                           through. I've seen the output
  86.                           like so:
  87.  
  88. BBS Name Goes Here  - Node : 9
  89. Who Called? - V2.98 - Written By: Bill Fink
  90.  
  91.                              Time  Min. Connect #Msgs  Files  Files  Avg
  92. Date      User Name          On    Used Speed    Left   U/L    D/L   CPS
  93. ----------------------------------------------------------------------------
  94. 03-23-92  HORACIO CRISTIN Off20:51  4   (2400)     0      0     0
  95. 03-23-92  ALEX BOWMAN Off Abn20:07  25  (19200E)   4      0     0
  96. 03-23-92  MARTIN HARDY Off Nor8:48  52  (2400)     0      0     2    230
  97. 03-23-92  MITCH KRZYZEK Off No8:43  1   (2400)     0      0     0
  98.  
  99. Previous xx Callers Tracked.
  100.  
  101. The above will also happen if the BBS does not post a full
  102. user cycle in your caller file. Like So: 
  103.  
  104. (NOTE:Martin Hardy Did NOT Officially log off:
  105.  
  106. **************************************************************
  107. 03-23-92 (18:43) (2) MITCH KRZYZEK (2400) (A) MIDDLETOWN, RI  
  108.       Modem: PROT: NONE CONNECT 2400                          
  109.       Caller Security: 60                                     
  110.       English Language is now active.                         
  111.       Directory Scan for (032292)                             
  112.       Minutes Used: 1                                         
  113. 03-23-92 (18:44) (2) MITCH KRZYZEK Off Normally               
  114. **************************************************************
  115. 03-23-92 (18:48) (2) MARTIN HARDY (2400) (G) NEWPORT, RI      
  116. **************************************************************
  117. 03-23-92 (20:07) (2) ALEX BOWMAN (19200E) (A) PORTSMOUTH, RI  
  118.       Modem: PROT: LAP-M COMP: V.42BIS CONNECT 9600/ARQ       
  119.       Caller Security: 60                                     
  120.       Message Left: Main Board # 10899                        
  121.       Minutes Used: 25                                        
  122. 03-23-92 (20:32) (2) ALEX BOWMAN Off Normally                 
  123. **************************************************************
  124.  
  125. You can elect to put "Who Called?" in your $$LOGOFF.BAT,
  126. which runs at the end of EACH user session on PCBoard
  127. v14.5a. (PCB Version 14.5, you'll need to edit your
  128. BOARD.BAT file, to include $$LOGOFF.BAT, and instruct
  129. PCBSETUP to DROP to DOS after each call.) OR you may choose
  130. to install it as a daily event, which would give something
  131. like a "Who Called The Day Before" bulletin for your BBS.
  132.  
  133. Who Called? Uses the CALLER file for it's information. You
  134. can limit the number of callers that it checks and writes to
  135. your bulletin using the WHOCALL.CNF file. (See WhoCALL.CNF
  136. File and read the EXPLAIN.CNF help file.)
  137.  
  138. Sometimes my "CALLERS" files gets pretty big. Keeping  in
  139. mind, this will effect "Who Called?" as it has to search the
  140. "CALLERS" file EACH time a user logs off. Thus, the bigger
  141. the "CALLERS" file, the longer "Who Called?" is going to
  142. take. I have been using "Who Called?" with a callers file
  143. 500+K in size, limiting to 50 calls. It takes a good 10-15
  144. seconds to complete it's work. (I am running PCB14.5a, DV
  145. 386, with three nodes - on a 386/33)
  146.  
  147. I elected to write the code to output a file called
  148. BULLETIN. (Then you simply copy THAT file to your designated
  149. "Who Called" bulletin. Do that in your LOGOFF.BAT)  I did this to
  150. avoid any share violations. I wanted to be careful! I know
  151. there's a routine out there to check this, but this is SAFE!
  152.  
  153. I can be reached at (401) 848-9176. PLEASE this is my HOME
  154. VOICE PHONE, try to keep it EARLIER than 6PM. (I'm taking
  155. into account Pacific time) Let's face it, it's a lot easier
  156. if we can talk voice.
  157.  
  158. My BBS phone numbers are (401) 848-2981 and (401) 846-1763,
  159. (Node III - 401-846-1763) which are at least 9600 v32, 
  160. should you prefer to SEE the bulletins in action. 
  161. (And keep tabs on any upgrades.) 
  162.  
  163. Use node III (401) 846-1763 to browse my 
  164. bulletins files, take a look at my bulletin #16  &  #17
  165. and leave a comment, asking for help should you need any.
  166.  
  167. What EVER you do, PLEASE don't try WHOCALLED and if something
  168. went wrong, just delete all the files and forget about it. 
  169. Please call me, and let me know if the utility is not 
  170. working for you for your configuration. I can NOT attempt
  171. to fix something, if I don't know it's broken. 
  172.  
  173. May I at LEAST ask, that if you DO use "Who Called?", on
  174. that special occasion that you just leave a note SOMEWHERE
  175. telling me? It'd be nice to know who, if ANYONE, is using
  176. this product. That's ALL. It will at least prompt me to keep
  177. on working on the next column. (Call, leave a note, and tell
  178. me what that last column should be. I'll know you're using
  179. this Fantastically PRICED product.)
  180.  
  181. I will NEVER know if you want something added, or something
  182. special for YOUR BBS if you don't call. Please CALL!
  183.  
  184. Bill Fink - SysOp/Owner/Manager - NCCBBS
  185. Middletown, Rhode Island
  186.  
  187.  
  188. Appended: 9 August 1992
  189.  
  190. If you have seen verson 1.0, you'll LOVE this one. The enhancements
  191. are speed, and a lot of cosmetics. Yet, the BEST error trapping.
  192.  
  193. I've had a couple of operators from around the country call and
  194. ask to have the date separator OPTION and to install MORE callers
  195. to exclude. Done!
  196.  
  197. 12 August 1992
  198.  
  199. Thanks Rick Welshan... for catching the utility only catching
  200. ONE name for excluding. (Better yet, thanks for letting me 
  201. KNOW. Which is far more generous.)
  202.  
  203. 18 September 1992
  204.  
  205. WOW, MANY new Users of WhoCalled? and a LOT of them are calling
  206. in to let me know it's working fine. I truly appreciate those
  207. that let me know of the "QUIT" bug in the WHOSETUP.EXE. Fixed.
  208. I took out a loop routine to help speed things up. My biggest 
  209. goal at this point is to get it working lightning fast. It's not
  210. fast enough for me.